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This Technical Note shows how to clear the "backup needed bit" in a directory entry's access 
byte. 



If you are writing a file backup utility program, you probably want to clear the backup needed bit 

in each directory entry's access byte as you make the backup of the file associated with that 
directory entry. The SET_FILE_INFO MLl call normally sets the backup needed bit of the 
access byte, but how do you clear it? The answer is at location BUBIT ($BF95) on the 
ProDOS 8 system global page. 

BUBIT normally contains the value $00. When BUBIT contains $00, the SET_FILE_INFO 
MLI call always sets the backup needed bit in the directory entry's access byte. However, if 
the value $20 is stored in BUBIT immediately before calling SET_FILE_INFO, the backup 
needed bit in the directory entry's access byte can be cleared. BUBIT is set back to $00 by the 
MLl call. The following code example shows how to clear the backup needed bit. Values other 
than $20 or $00 in BUBIT are not supported. 

; The pathname of the file should be in ThePathname buffer when this code is called! 

65816 off 
longa off 
longi off 

ClearBackupBit start 

; System global page locations 

MLI equ $BFOO 

BUBIT equ $BF95 

; MLI call numbers 

SET_FILE_INFO equ $C3 
GET_FILE_INFO equ $C4 

; set up Fileinf oParms for GET_FILE_INFO MLI call 
Ida #$0A 
sta param_count 

; then. . . 

jsr MLI ;get the current file info 

dc II ' GET_FILE_INFO ' 
dc 12 ' Fileinf oParms ' 
bne Error 



;MLI call entry point 

; Backup Bit Disable, SET FILE INFO only 
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Ida #$20 
sta BUBIT 
eor #$FF 

and access 
sta access 



;set the backup bit disable bit 



; clear the backup needed bit 



; set up Fileinf oParms for SET_FILE_INFO MLI call 
Ida #$07 
sta param_count 



then. 



Error 



jsr MLI 

dc II' SET_FILE_INFO ' 
dc 12 ' Fileinf oParms ' 
bne Error 
rts 

anop 
rts 



; set the file info with the file info 
; (clearing only the backup needed bit) 



; return to caller 

; routine to handle MLI errors 



Parameter block used for GET FILE INFO and SET FILE INFO MLI calls 



Fileinf oParms 


anop 


param count 


ds 


1 


pathname 


dc 


i 


access 


ds 


1 


f ile_type 


ds 


1 


aux_type 


ds 


2 


storage_type 


ds 


1 


blocks_used 


ds 


2 


mod_date 


ds 


2 


mod_time 


ds 


2 


create_date 


ds 


2 


create time 


ds 


2 



ThePathname 



entry 
ds 65 



; store the pathname of the file here 



end 



Further Reference 

• ProDOS 8 Technical Reference Manual 
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